home *** CD-ROM | disk | FTP | other *** search
/ FishMarket 1.0 / FishMarket v1.0.iso / fishies / 476-500 / disk_500 / wiconify / wutilities.lzh / wSetSysRequest / wSetSysRequest.doc < prev    next >
Text File  |  1991-04-19  |  2KB  |  62 lines
  1. OVERVIEW:
  2.  
  3. wSetSysRequest is a companion program to wIconify that allows CLIs openned
  4. on screens other than the Workbench screen to have their system request
  5. messages show up on the screen where they are running, rather than on the WB
  6. screen.  While not strictly necessary, this provides a somewhat more
  7. friendly environment when you are using CLIs on alternate screens.
  8.  
  9.  
  10. USING WSETSYSREQUEST:
  11.  
  12. You can specify both the process to be affected and the screen on which that
  13. processes system requests will open.
  14.  
  15. To specify a process, you must give its process name (not its CLI task
  16. number), you may need to use a utility like AmigaMonitor to find the names
  17. of the active tasks.  If you do not specify a task name (or provide a blank
  18. name such as "") then the current process is used by default.
  19.  
  20. To specify a screen, use its screen title.  If the title includes spaces, be
  21. sure to enclose the title in quotation marks.  You need only specify as much
  22. of the name as needed to distinguish the screen from other screens.  Upper
  23. and lower case letters are not distinguished.  If you do not specify a
  24. screen title, the currently active screen is used by default.
  25.  
  26. For example,
  27.  
  28.    1> wSetSysRequest "" "Workbench"
  29.  
  30. sets the system request screen for the current task to the workbench screen.
  31. On the other hand
  32.  
  33.    1> wSetSysRequest "New CLI"
  34.  
  35. will set the system request screen for the process called "New CLI" to the
  36. currently active window.
  37.  
  38. Programs started from the Workbench will have their process names set to the
  39. name of the program that is running, but unfortunately, CLIs and programs
  40. that are RUN from CLIs are given names like "New CLI" and "Background CLI".
  41. wSetSysRequest can not distinguish among these, so it is best not to
  42. attempt to specify these processes by name.
  43.  
  44. The typical usage of wSetSysRequest is to issue the command without
  45. specifying either a process or a screen.  This will set the system requests
  46. for the CLI where the command was issued to the currently active screen.
  47.  
  48. Once a CLI has had its system request screen set, it will propagate that
  49. screen to any commands that are executed from that CLI, including commands
  50. that are started via RUN.  It does NOT propagate, however, to new CLIs
  51. created via NewCLI or NewShell.  You must call wSetSysRequest for each of
  52. these explicitly (usually within the S:SHELL-STARTUP file for new shells).
  53.  
  54.  
  55. AUTHOR:
  56.  
  57. Davide P. Cervone
  58. Mathematics Department
  59. Brown Univerisy
  60. Providence, Rhode Island  02912
  61. ST402523@BROWNVM
  62.